home *** CD-ROM | disk | FTP | other *** search
/ Corel CD Power Pak: Utilities / Corel CD Power Pak: Utilities.iso / scsi2 / aspiibm.cmd < prev    next >
OS/2 REXX Batch file  |  1993-10-22  |  8KB  |  210 lines
  1.          ASPIDRIVER IBM V1.00 command line switches
  2.         ------------------------------------------
  3.  
  4. DEVICE=ASPIIBM.SYS [/l] [/m] [/n<slot>] [/a<bus-on time>] [/b<bus-off time>]
  5.     [/i] [/d <HAN>,<ID>,<BYTE>] [/z <slot>] [/s<scsi-speed>] [/r[w]]
  6.  
  7. /L    enable nonzero LUN SCSI scanning at boot (for ASPI=1 GetDeviceType)
  8. /M    disable full message display during boot
  9.  
  10. /I    disable int 13h module loading;by default int 13h module is loading
  11.     for first ibm host adapter recognized:if autoscanning is enabled
  12.     (no /n option set) the driver assigns as the first adapter the ibm
  13.     adapter at the LOWEST slot number
  14.  
  15.     NOTE : if you are booting from a SCSI hard disk and you are loading
  16.     ASPIIBM.SYS DO NOT USE /I option
  17.  
  18. /Z<slot>exclude slot from install (MCA BUS)
  19. /N<slot>install slot number (MCA BUS) - can be given multiple times
  20.     if no /n option exists the driver is autoscanning the SCSI bus and
  21.     installing all supported cards on MCA BUS-slot increasing order
  22.  
  23. /R    do SCSI hard reset to all found host adapters.This option is useful
  24.     after a host adapter previous "hang" (the host adapter LED remains
  25.     on after reset,the card is not recognised at boot by the driver,etc)
  26. /RW    do SCSI hard reset and wait 5 seconds before any SCSI request is made
  27.     to the host adapter (for slow old SCSI devices that could "hang" the
  28.     host adapter after SCSI bus reset is sent)
  29.  
  30. /D<HAN>,<ID>,<BYTE> set unique parameter byte configuration option for
  31.     the specified host adapter and SCSI ID.You can set the following bits
  32.         bit2-prevent target disconnect
  33.         bit3-no autosense
  34.         bit6-disable special ibm cached read/write commands for int 13h
  35.     For details about the configuration byte see ASP=5 Set Host Adapter
  36.     parameters 
  37.  
  38. /A<bus on  time decimal> - specifies the amount of relative time the host
  39.     adapter bus master is allowed to hold the bus 
  40. /B<bus off time decimal> - specifies the amount of relative time the host
  41.     adapter bus master must release the bus 
  42.  
  43.     On the IBM card the buson value means the percentage of 100% of the
  44.     MCA bus bandwidth to be used:tbuson+tbusoff=100 (if not it is displayed
  45.     an appropiate error);
  46.  
  47.     NOTE:BOTH switches must be specified for programming the DMA pacing 
  48.     factor
  49.  
  50. /S<SCSI synchronuous transfer speed hexa> - specifies the SCSI timing of the host adapter
  51.     the allowed values are
  52.  
  53.     scsi speed    scsi sync rate (IBM) (MB/s)
  54.      0         5.00
  55.      1         4.00
  56.      2         3.33
  57.      3         2.86
  58.      4         2.50
  59.      5         2.22
  60.      6          2.00
  61.      7         1.82
  62.  
  63.  
  64.         ASPIDRIVER IBM V1.00 initialization and mesages
  65.         -----------------------------------------------
  66.  
  67.     Note : most of the initialization messages can be disabled to be 
  68.     displayed with the /M option.
  69.  
  70.     After the initial message
  71.  
  72.     "CorelASPI for DOS - device driver V1.00"
  73.     "Copyright (c) 1992-1993 Corel Corp."
  74.  
  75.     the driver starts processing of the config.sys line. If any i/o slots
  76.     are specified the driver tries installing only the cards that
  77.     correspond to the specified slots;else the driver scans the MCA 
  78.     bus for valid SCSI supported cards and installs them all. If none is 
  79.     found the driver exits without installing with the message
  80.  
  81.     "No supported SCSI cards located"
  82.     "Driver is not installed"
  83.  
  84.     At the end of the initialization the exit message displays the
  85.     number of SCSI cards installed.
  86.  
  87.      "Installation complete : x SCSI  card(s)   located"
  88.  
  89.     x-number of installed cards
  90.  
  91.     Any config.sys command error is ignored with the message
  92.  
  93.     "Unknown command line errors ignored"
  94.  
  95.     The per card host adapter specific initialization starts with the 
  96.     message
  97.  
  98.         "Initialising host adapter : x"
  99.      "Configuration I/O : yyyy, IDD : d, IRQ : bb, DMA : a"
  100.  
  101.     x-host adapter number (0 based)
  102.     yyyy-base I/O port for the card
  103.     d-the bord ID byte as returned by adapter inquiry command
  104.     bb-interrupt level for the card
  105.     a-dma channel for the bus master chip
  106.  
  107.     Also the slot number is displayed
  108.  
  109.     "Microchannel slot : x"
  110.  
  111.     x-slot number (1-8)
  112.  
  113.     Then the driver is displaying the IBM host type and bus width
  114.  
  115.     "  Host : IBMSCSI/xx Va.bb"
  116.  
  117.     xx=16/32 bits the bus width
  118.     a.bb the firmware revision number
  119.  
  120.     The driver is scanning the SCSI bus for present devices and displayes
  121.     the results. If the /L option is specified the scanning is made for
  122.     every SCSI LUN on a given SCSI ID, else the inquiry is made only for
  123.     LUN = 0 on a given ID.
  124.  
  125.     The /A /B /S command line switches display the programming of the
  126.     specified parameters. These parameters are GLOBAL for EVERY installed
  127.     card.
  128.  
  129.     "    Configuring DMA pacing factor to xxx%, host : yy"
  130.  
  131.     "     Configuring SCSI synchronuous speed to zz.z MB/s"
  132.  
  133.     xxx-percentage of bus used
  134.     yy=host adapter number
  135.     zz.z-value in mbytes/second of the scsi synchrounuous transfer rate
  136.  
  137.     If the per card initialization is succesfull the last message is
  138.  
  139.         "Initialising complete host adapter : x"
  140.  
  141.     else
  142.  
  143.     "Initialising error host adapter : x error : yyyy"
  144.  
  145.     x-host adapter number (0 based) 
  146.     yyys-the error code
  147.     In this last case the driver displays also a corresponding error 
  148.     string.Also in should be noted that in this last case the driver is
  149.     not installing FOR the specified card.
  150.  
  151.     If there are any present SCSI hard disks, the driver changes the
  152.     hard disk interrupt services vector. If there are any CMOS installed
  153.     hard disks, the driver installs the vector after them.Remember that 
  154.     the /I option disables the loading of the int 13h vector. Use this 
  155.     option if you have no SCSI hard drives    in your system, so that the 
  156.     driver do not keep the code for int 13h resident. 
  157.  
  158.     Upon succesfull instalation of the vector the driver displays the 
  159.     message
  160.  
  161.     "ASPI - hard disk interrupt SCSI module  V1.00"
  162.     "INT 13H redirected - for X:,Y drive(s)"
  163.  
  164.     X=start drive for which the vector is installed (C: or D:) 
  165.     Y=number of SCSI hard drives for which the vector is installed
  166.  
  167.     Following are the int 13h error messages
  168.  
  169.     "SCSI device id 0 lun 0 not a direct access device"
  170.  
  171.     "INT 13H function error"-the BIOS read drive parameters failed
  172.  
  173.     "Read test INT 13h error"-the verify test with the new int 13h
  174.     vector failed.
  175.  
  176.     The autoscan on MCA bus is in the order slot #1 to slot #8.
  177.  
  178.     If the slot in which the SCSI boot hard disk is present is AFTER
  179.     another IBM SCSI card slot (slot 4 non bootable SCSI card, SCSI 6 hard
  180.     disk to boot from), the int 13h vector will not install properly
  181.     unless you specify on the command line /n6 /n4 as in our
  182.     example, to force the installation of the cards in your own order.
  183.     This will ensure that the boot host adapter number IS zero
  184.     and the int 13h vector installs by default.Alternately you can assign
  185.     in a lower slot the IBM card that has the bootable hard drive;
  186.     Attention : for correct functioning with more than one IBM card in the
  187.     system you must insure that the BOOTABLE hard drive is always on the
  188.     first IBM host adapter 
  189.  
  190.     NOTE:    After installing Windows you may REM the config.sys line
  191.         device=c:\windows\smartdrv.exe /DOUBLE_BUFFER.This option is
  192.         not needed by the ASPI MANAGER
  193.     NOTE:    MCA bus = IBM MicroChannel PS/2 I/O bus
  194.  
  195.     NOTE:    NEW FEATURES
  196.         1.support for > 1 GB hard drives if BIOS supports it also
  197.         2.support for > 2 hard drives if DOS 5.0 or higher present
  198.         on multiple host adapters;for each host adapter the drives
  199.         letters are assigned in SCSI ID decreasing order, and for 
  200.         multiple hosts they are assigned in slot increasing order
  201.         SCSI ID's must not be contiguous.
  202.  
  203.     NOTE:    Through IBM configuration from the reference diskette you
  204.         can change the hard disk boot device : for example if you have
  205.         two hard disks SCSI ID=6 and ID=4 the normal boot drive is from
  206.         ID=6;with Set features menu you can specify in Set startup
  207.         sequence to boot from drive at ID=4;When loading ASPIDRV.SYS
  208.         DO NOT USE THIS OPTION;ASPIDRV.SYS will always try to boot
  209.         from hard disk ID=6 (as in our example).
  210.